home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / mktty.man < prev    next >
Encoding:
Text File  |  1989-04-06  |  2.8 KB  |  65 lines
  1. ' $Header: /a/newcmds/mktty/RCS/mktty.man,v 1.1 89/04/06 15:11:35 ouster Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS MKTTY cmds
  4. .BS
  5. .SH NAME
  6. mktty \- Create pseudo-terminal with 4.3 BSD line discipline
  7. .SH SYNOPSIS
  8. \fBmktty \fIrawTty\fR \fIpdevName\fR [\fIcommand arg arg ...\fR]
  9. .BE
  10.  
  11. .SH DESCRIPTION
  12. .LP
  13. Given a raw serial line device, \fBmktty\fR generates a pseudo-device that
  14. behaves like a terminal under 4.3 BSD UNIX, with most of the
  15. features of the 4.3 BSD terminal driver.
  16. \fIRawTty\fR is the name of a device file for a serial line.  \fBTty\fR will
  17. read keyboard input from this file in raw mode and write screen output
  18. to the file, also in raw mode.  \fBTty\fR will create a pseudo-device
  19. at \fIpdevName\fR;  input from \fIrawTty\fR will appear as input on
  20. \fIpdevName\fR after line-editing and other input-related features of
  21. the 4.3 BSD terminal driver.  Output to \fIpdevName\fR will eventually
  22. appear as output on \fIrawTty\fR, after processing that simulates
  23. the features of the 4.3 BSD terminal driver.  All of the 4.3 BSD
  24. I/O-control operations may be performed on \fIpdevName\fR, except
  25. for the exceptions listed below.  Thus if a user's terminal is connected
  26. to \fIrawTty\fR and if the user's applications all talk to \fIpdevName\fR,
  27. everything will behave as it did under 4.3 BSD UNIX.
  28. .LP
  29. If \fIcommand\fR is given as an argument to \fBmktty\fR, it (and the following
  30. arguments) are executed with \fIpdevName\fR as standard input, standard
  31. output, and standard error.
  32. .LP
  33. \fBTty\fR also supports a special mode of operation where it uses a network
  34. connection instead of a raw serial line device.  If \fIrawTty\fR contains
  35. a colon character, then it is assumed to have the form \fIhost\fB:\fIportNum\fR,
  36. where \fIhost\fR is the name of a host and \fIportNum\fR is a decimal
  37. port number within that host.  In this case, \fBmktty\fR will open a TCP connection
  38. to the given port and will use it for reading and writing characters
  39. to the supposed terminal.  This feature is designed for use with the
  40. \fBrtty\fR program, which is capable of supporting the other end of the TCP
  41. connection.
  42.  
  43. .SH "UNIMPLEMENTED FEATURES"
  44. .LP
  45. For details on the features implemented by \fBmktty\fR, see the 4.3 BSD
  46. man page TTY(4).
  47. \fBTty\fR implements all of the functionality of the 4.3 BSD
  48. ``new'' line discipline except for the following:
  49. .IP \(bu
  50. Control terminal:  there is no ``/dev/tty'' device yet in Sprite.
  51. .IP \(bu
  52. Output delays, such as BS0 and TAB0 are not implemented;  the
  53. delay-related flags in sgttyb structs are ignored, except for
  54. XTABS, which doesn't specify a delay and is implemented.
  55. .IP \(bu
  56. Parity is not generated or checked.
  57. .IP \(bu
  58. The LTILDE, LTOSTOP, LETXACK, and LINTRUP local mode flags are ignored.
  59. .LP
  60. \fBTty\fR only implements the ``new'' line discipline:  the ``old'' and
  61. ``net'' disciplines are not implemented.
  62.  
  63. .SH KEYWORDS
  64. line discipline, pseudo-device, terminal driver
  65.